home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / utmisc1 / xpkrchvp.lha / XpkArchivePackage / XArcTool.dok < prev    next >
Text File  |  1996-05-07  |  12KB  |  283 lines
  1.  
  2.  
  3.                             XArcTool V2.0
  4.                             =============
  5.  
  6.                        © 1995 by Matthias Meixner
  7.  
  8.  
  9.  
  10.                             Einführung
  11.                             ----------
  12. XArcTool ist eine graphische Benutzeroberfläche für die xpkarchive.library.
  13. Die Oberfläche ist dabei an Directory-Tools wie Opus oder Directorymaster
  14. angelehnt und gestattet es Archive genauso einfach zu handhaben wie normale
  15. Verzeichnisse. Man kann damit Dateien in Archive kopieren, Dateien aus
  16. Archiven extrahieren, Dateien zwischen verschiedenen Archiven kopieren, ohne
  17. sie dabei zu dekomprimieren und neu zu komprimieren, und als Zugabe auch
  18. Dateien wie mit einem normalen Directory-Tool zwischen zwei Verzeichnissen
  19. zu kopieren. Ausserdem ist es mit der xpkarchive.library auch möglich Dateien
  20. in einem Archiv umzubenennen, Kommentare zu Dateien anzulegen oder zu ändern
  21. und die Schutzbits zu ändern. Die xpkarchive.library bietet die Möglichkeit
  22. mehrere Versionen einer Datei in einem Archiv zu halten, dabei haben alle
  23. diese Versionen den gleichen Dateinamen. Um dies zu erreichen hat jede Datei
  24. zusätzlich noch eine Dateigenerationsnummer. Je höher diese
  25. Generationsnummer, desto neuer ist diese Datei (jedenfalls gilt dies solange
  26. man die Generationsnummer nicht manuell umgesetzt hat). Version 0 hat eine
  27. besondere Bedeutung, sie bezieht sich immer auf die Datei mit der höchsten
  28. Generationsnummer und damit i.d.R. auf die neueste Version einer Datei.
  29. All diese Funktionen werden bereits von der xpkarchive.library angeboten und
  30. XArcTool ist nur eine komfortable Benutzerschnittstelle zu dieser Library.
  31. Falls Sie die xpkarchive.library selbst benutzen wollen, lesen sie bitte die
  32. Dokumentation, die mit der xpkarchive.library kommt.
  33. Die Oberfläche von XArcTool ist bis zu einem gewissen Grad fontsensitiv.
  34. Falls der Font bei einem kleinen Fenster sehr gross ist, kann es passieren,
  35. daß die Texte nicht mehr in die Gadgets passen und so das Layout etwas
  36. durcheinander gerät. In diesem Fall reicht es jedoch aus, das Fenster zu
  37. vergrößern oder einen anderen Font zu wählen. Auf die Funktionalität hat
  38. dies jedoch keinen Einfluß.
  39.  
  40.  
  41.  
  42.                               Copyright
  43.                               ---------
  44.  
  45. XArcTool (C) Copyright 1995 by Matthias Meixner.  Alle Rechte vorbehalten.
  46. Dieses Programm ist GIFTWARE, was bedeutet, daß Sie, wenn Ihnen dieses
  47. Programm gefällt und sie es regelmäßig benutzen, den Autor mit einem
  48. angemessenen Geschenk belohnen sollten.
  49.  
  50. Dieses Programmpaket darf frei kopiert werden, solange es nur in seiner
  51. originalen Form, komplett und unmodifiziert weitergegeben wird. Es darf
  52. nicht kommerziell oder als Teil eines kommerziellen Programms ohne meine
  53. schriftliche Genehmigung vertrieben werden. Hiermit erhält Fred Fish die
  54. Erlaubnis dieses Programm auf seiner PD-Serie zu veröffentlichen.
  55.  
  56. Dieses Programm wird in der Hoffnung vertrieben, daß es nützlich ist, aber
  57. ohne jegliche Garantie, daß es einen bestimmten Zweck erfüllt. Die Benutzung
  58. geschieht auf eigene Gefahr!
  59.  
  60.  
  61.  
  62.  
  63.                               Aufruf
  64.                               ------
  65. Mit einem Doppelklick auf das "Installiere_Lib"-Icon wird die
  66. xpkarchive.library installiert. Danach kann man einfach die komplette
  67. Schublade in das Verzeichnis schieben, wo man XArcTool haben will.
  68.  
  69. vom CLI:
  70.  
  71. XArcTool PATH/M,P=PACKER/K,M=MODE/N,PW=PASSWD/K,L=LEFT/N,T=TOP/N,W=WIDTH/N,
  72.          H=HEIGHT/N,I=ICON/S
  73.  
  74. Option:     Effekt:
  75.  
  76. PATH/M      Hiermit kann man zwei Pfade angeben, die von XArcTool verwendet
  77.             werden sollen. Dabei kann es sich auch um Archive handeln, die
  78.             angezeigt werden sollen.
  79.  
  80.             z.B.   XArctool ram: hd0:
  81.  
  82. P=PACKER    Wählt die standardmäßige Packmethode aus.
  83.  
  84. M=MODE      Wählt den standardmäßigen Packmodus aus.
  85.  
  86. PW=PASSWD   Wählt das standardmäßige Paßwort für die Verschlüsselung aus.
  87.  
  88. L=LEFT,
  89. T=TOP,
  90. W=WIDTH,
  91. H=HEIGHT    Dient zum Angeben der Position und der Größe des Fensters von
  92.             XArcTool. LEFT und TOP geben dabei die linke obere Ecke an und
  93.             WIDTH und HEIGHT die Breite und die Höhe des Fensters.
  94.  
  95. I=ICON      Mit dieser Option erzeugt XarcTool Icons.
  96.  
  97. Ein weiteres Beispiel:
  98.  
  99.        XArcTool P=FEAL M=100 PW=test ICON ram:
  100.  
  101.    Hiermit benutzt XArcTool die Verschlüsselungsmethode FEAL im Modus 100
  102.    und verwendet "test" als Paßwort. Der Pfad der linken Verzeichnisliste
  103.    ist "ram:". Außerdem werden Icons für neu erzeugte Archive angelegt.
  104.  
  105.  
  106. Aufruf von der Workbench:
  107.  
  108. Mit der Workbench kann man die gleichen Optionen wie vom CLI benutzen.
  109. Dazu ergänzt man einfach pro Option eine Zeile in den Tooltypes des Icons.
  110. Außerdem kann man die PATH-Option über mehrfache Selektion der Workbench
  111. ausnutzen. Dazu klickt man zuerst XArcTool einfach an, drückt die
  112. Shift-Taste und klickt danach Verzeichnisse oder Archive an und beendet dies
  113. mit einem Doppelklick auf dem letzten Icon. Sehr nützlich in diesem
  114. Zusammenhang sind die the LEFT,TOP,WIDTH und HEIGHT Optionen, mit denen man
  115. die Position und Größe des Fensters einstellen kann.
  116.  
  117.  
  118.  
  119.  
  120.                       Benutzen von XArcTool
  121.                       ---------------------
  122.  
  123. Beim Start öffnet XArcTool ein Fenster mit zwei Verzeichnislisten, eine auf
  124. der linken und eine auf der rechten Seite. Die TextGadgets darüber enthalten
  125. den Pfadnamen der Verzeichnisse, die gerade angezeigt werden. Das obere der
  126. beiden Textgadgets enthält dabei den Pfad auf dem Datenträger und das untere
  127. der beiden den Pfad innerhalb eines Archivs, falls im oberen Textgadget
  128. ein Archiv angewählt wurde. Der Pfeil in der Mitte zwischen dem linken und
  129. dem rechten Textgadget gibt an, in welcher Richtung kopiert wird und legt
  130. damit das Quellverzeichnis und das Zielverzeichnis fest. Das
  131. Quellverzeichnis ist jeweils das Verzeichnis, von dem der Pfeil wegzeigt.
  132. Alle Operationen beziehen sich immer auf das Quellverzeichnis.
  133. Archive werden genauso gehandhabt wie Verzeichnisse, nur mit dem Unterschied,
  134. daß zusätzliche Funktionen möglich sind. Falls man also eine Datei aus einem
  135. Verzeichnis in ein Archiv kopiert, so wird sie dabei automatisch komprimiert,
  136. während sie dekomprimiert wird, wenn man sie aus einem Archiv in ein
  137. Verzeichnis kopiert. Kopieren zwischen zwei Archiven führt nicht zu einer
  138. Dekompression und einer neuen Kompression dieser Datei und ist deshalb recht
  139. schnell.
  140.  
  141. Anlegen von Archiven oder Verzeichnissen:
  142. Dazu tippt man einfach den Namen des Verzeichnisses bzw. des Archivs in das
  143. Textgadget für den Pfad ein. Daraufhin erscheint ein Requester, der angibt,
  144. daß dieses Objekt nicht existiert und fragt, ob man es als Verzeichnis oder
  145. als Archiv anlegen möchte. Archive erhalten automatisch die Endung ".xar",
  146. falls sie nicht schon eine Endung angegeben haben.
  147. Außerdem kann man dazu auch die Knöpfe "Neues Verz." oder "Neues Arch."
  148. verwenden, um ein neues Verzeichnis oder ein neues Archiv anzulegen.
  149.  
  150. Kopieren/Komprimieren/Dekomprimieren von Dateien:
  151. Dazu selektiert man einfach mit einem Mausklick die zu kopierenden Dateien
  152. oder wählt Dateien über ein Muster mit dem Menü aus und wählt danach
  153. "Kopieren" an. Abhängig von den angewählten Verzeichnissen/Archiven werden
  154. die Dateien (De)Komprimiert oder einfach kopiert.
  155. Mit einem Doppelklick auf ein Verzeichnis kann man in dieses hinabsteigen,
  156. mit einem Doppelklick auf ein Archiv in dieses hineinwechseln.
  157.  
  158. Umbenennen von Dateien:
  159. Einfach die Dateien anwählen und auf "Benennen" klicken. Daraufhin
  160. erscheint ein Requester, in dem man den neuen Namen angeben kann und falls
  161. die Datei einem Archiv angehört auch die Dateigeneration ändern kann.
  162. Genauso kann man auch Verzeichnisse umbenennen.
  163. (Siehe auch die Information zu den Dateigenerationen)
  164.  
  165. Dateien löschen:
  166. Man löscht Dateien einfach indem man sie selektiert und "Löschen" anwählt.
  167. Dateien innerhalb von Archiven werden in Abhängigkeit vom Archivtyp nur
  168. als gelöscht markiert. Die Dateien werden dann erst mit "Packen" aus dem
  169. Archiv entfernt.
  170.  
  171. "Wiederherst." dient nun dazu die Löschmarkierung von Dateien zu entfernen,
  172. das Löschen also rückgängig zu machen. Dies ist natürlich nur dann möglich,
  173. wenn die Datei nicht bereits aus dem Archiv entfert wurde.
  174.  
  175. Mit "Kommentar" kann man Dateikommentare sezten, mit "Schutz" die
  176. Schutzbits der Dateien ändern.
  177.  
  178. Archive Packen:
  179. "Packen" entfernt alle als gelöscht markierten Dateien aus einem Archiv und
  180. außerdem überflüssige Informationen, die durch Umbenennen von Dateien oder
  181. durch Setzen von neuen Dateikommentaren entstanden sind. Nachdem ein Archiv
  182. gepackt wurde, ist es nicht mehr möglich gelöschte Dateien
  183. wiederherzustellen.
  184.  
  185. Mit "Direkt-Kom." kann man eine Kommandozeile direkt an die
  186. archive-sublibrary schicken. Die Funktion ist dabei nur von der Sublibrary
  187. abhängig. (Siehe die Dokumentation der Sublibrary).
  188.  
  189. Mit "Optionen" kann man eine andere Packmethode oder einen anderen Packmodus
  190. einstellen, desweiteren kann man hier auch das Paßwort einstellen, das bei
  191. den Verschlüsselungsverfahren verwendet wird, falls ein solches eingestellt
  192. wurde.
  193.  
  194. "/" dient dazu in ein übergeordnetes Verzeichnis zu wechseln.
  195.  
  196. "Lesen" liest das Quellverzeichnis neu ein. Dies ist notwendig, wenn von
  197. einem anderen Programm eine Datei in dieses Verzeichnis geschrieben wurde
  198. und diese angezeigt werden soll.
  199.  
  200. Das Listview-Gadget unterhalb des "Lesen"-Gadgets erlaubt das Auswählen
  201. eines neuen Datenträgers für das Quellverzeichnis.
  202.  
  203. "Sync"-Gadget:
  204. Dieses Gadget ist äußerst nützlich. Wenn es aktiviert ist, geschehen alle
  205. Verzeichniswechsel durch Doppelklick auf einen Eintrag in einer
  206. Verzeichnisliste oder durch Klick auf "/" synchron auf beiden Seiten. Dies
  207. erlaubt ein einfaches Duplizieren von kompletten Verzeichnisstrukturen.
  208.  
  209.  
  210. Menüs:
  211. ------
  212.  
  213. Projekt
  214.    Über:        Informationen über XArcTool.
  215.    Ende:        XArcTool beenden
  216.  
  217. Extras:
  218.    Alles markieren:  Markiert alle Dateien im Quellverzeichnis
  219.    Muster markieren: Benutzt ein Muster, um Dateien im Quellverzeichnis zu
  220.                      markieren.
  221.  
  222.    Alles demarkieren: Demarkiert alle Dateien des Quellverzeichnisses.
  223.    Muster demarkieren: Benutzt ein Muster, um Dateien im Quellverzeichnis zu
  224.                        demarkieren.
  225.  
  226.  
  227.                         Was XArcTool so alles anzeigt
  228.                         -----------------------------
  229. XArcTool zeigt folgende Informationen in den Verzeichnislisten an:
  230.  
  231. Für normale Verzeichnisse (in dieser Reihenfolge):
  232. Dateiname Dateigröße Schutzbits Datum&Zeit Dateikommentar
  233.  
  234. Für Archive:
  235. Dateiname Generationsnummer (Komprimierte Größe) Dateigröße Packmethode
  236.                   Schutzbits Datum&Zeit Dateikommentar
  237.  
  238.  
  239.  
  240.  
  241.                            Dateigenerationen
  242.                            -----------------
  243. Die xpkarchive.library kann mehrere Versionen einer Datei mit dem gleichen
  244. Dateinamen in einem Archiv halten. Diese werden durch ihre Generationsnummer
  245. unterschieden (d.h. sogar wenn mehrere Dateien die gleiche Versionsnummer
  246. haben, kann man sie immer noch per Mausklick auswählen!).
  247. Die xpkarchive.library versucht die Generationsnummern auf einem sinnvollen
  248. Stand zu halten. Falls man also z.B. eine Datei an ein Archiv anhängt, in
  249. dem bereits eine Datei mit dem gleichen Namen existiert, so erhält die neue
  250. Datei die nächst höhere Generationsnummer. Die Generationsnummer 0 hat eine
  251. besondere Bedeutung: sie bezieht sich auf die Datei mit der höchsten
  252. Generationsnummer (mit einem bestimmten Namen), also in der Regel auf
  253. die neueste Datei eines Namens.
  254.  
  255.  
  256.  
  257.                                 History
  258.                                 -------
  259. 2.0: Unterstützung für die neuen Funktionen der xpkarchive.library V2.0
  260.  
  261. 1.4: verwendete SetWindowPointer unter V37, was jedoch erst ab V39 existiert,
  262.      korrigiert
  263.  
  264. 1.3: erste öffentlich verfügbare Version
  265.  
  266.  
  267. Was zu tun bleibt:
  268. Eine bessere Dokumentation schreiben.
  269.  
  270.  
  271. Falls Sie Fehler finden, Fragen haben oder ??? schreiben Sie an:
  272.  
  273.    Matthias Meixner
  274.    Sandberg 13
  275.    36145 Schwarzbach
  276.    Deutschland
  277.  
  278. EMail:
  279.    meixner@rbg.informatik.th-darmstadt.de
  280.  
  281.  
  282.  
  283.